home *** CD-ROM | disk | FTP | other *** search
/ Sound Effects for Multimedia 2 / Sound Effects for Multimedia - Volume 2.7z / Sound Effects for Multimedia - Volume 2.bin / mac / XTRAS / POPMENU XTRA™ / POPMENU XTRA™.rsrc / TEXT_1001_text_help.txt < prev    next >
Text File  |  1997-03-17  |  6KB  |  130 lines
  1. -----------------------
  2. Purchasing PopMenu Xtra
  3. -----------------------
  4.  
  5. To license PopMenu Xtra, please contact g/matter, inc. at
  6.  
  7. <sales@gmatter.com>
  8.  
  9. or at
  10.  
  11. +1-415-243-0394  phone
  12. +1-415-243-0396  facsimile
  13.  
  14. 300 Brannan Street, Suite 210
  15. San Francisco, California  USA  94107
  16.  
  17. http://www.gmatter.com/
  18.  
  19. ------------------------
  20. Registering PopMenu Xtra
  21. ------------------------
  22.  
  23. To register PopMenu Xtra, choose "PopMenu-->Register" from the Xtras menu. You will be presented with a dialog box in which you should type your serial number. Although this writes a registration file to disk, you do not need to distribute any files with your projectors except for the actual PopMenu Xtra files.
  24.  
  25. -----------------------
  26. Installing PopMenu Xtra
  27. -----------------------
  28.  
  29. PopMenu Xtra consists of 3 files:
  30.  
  31. PopMenu XtraΓäó     --    the Macintosh 68K and PowerPC Xtra
  32. PopMenu.x16       --    the 16-bit Windows Xtra
  33. PopMenu.x32       --    the 32-bit Windows Xtra
  34.  
  35. When Director launches, it automatically locates Xtras by looking in two special places:
  36.  
  37. Macintosh
  38. ---------
  39. Location #1:    The Xtras folder which is in the same location as your Director application.
  40.  
  41. Location #2:    The Macromedia:Xtras folder contained in your System folder.
  42.  
  43. Windows
  44. -------
  45. Location #1:    The Xtras subdirectory which is in the same location as your Director application.
  46.  
  47. Location #2:    The Windows\Macromed\Xtras subdirectory on Windows 3.1 -OR- The Program Files\Common Files\Macromedia\Xtras subdirectory on Windows 95 or Windows NT.
  48.  
  49. To make the PopMenu Xtra available to your copy of Director, you simply need to copy the PopMenu Xtra folder/subdirectory contained on the enclosed CD onto your hard disk in the appropriate place as described above.
  50.  
  51. Macintosh
  52. ---------
  53. Copy the folder located on the root of the CD named "PopMenu XtraΓäó"
  54.  
  55. Windows
  56. -------
  57. Copy the subdirectory located on the root of the CD named "POPMENU"
  58.  
  59. You can keep PopMenu Xtra in its own folder/subdirectory (Director will search up to 5 levels deep in the Xtras folder/subdirectory looking for Xtras at launch time.)
  60.  
  61. ----------------------------
  62. Installing PopMenu Xtra Help
  63. ----------------------------
  64.  
  65. PopMenu Xtra Help comes in the form of a single help file:
  66.  
  67. PopMenu XtraΓäó Help     --    the Macintosh Help File
  68. POPMENU.HLP       --    the Windows Help File
  69.  
  70. This file needs to be placed in a specific location for it to be accessible through the Xtras-->PopMenu Xtra--->Help command:
  71.  
  72. Macintosh
  73. ---------
  74. Place the help file into the "Help" folder where your Director application is located.
  75.  
  76. Windows
  77. -------
  78. Place the help file into the same subdirectory where your Director application is located.
  79.  
  80. --------------------------------------
  81. Using PopMenu Xtra -- A Quick Tutorial
  82. --------------------------------------
  83.  
  84. 1. From the Insert menu, choose "Red Eye Xtras-->PopMenu" and this will place a new PopMenu castmember in the cast.
  85.  
  86. 2. From the Insert menu, choose "Control-->Field" and this will place a new field in the cast. You'll use this field to create your menu definition.
  87.  
  88. 3. Double-click on the newly-created field castmember and name it "popup list". You can call it anything you like. Now, define a popup menu by placing the names of each menu item in the list. Each item should be separated by a return or a semi-colon character and to define a submenu, you should use the left square brace. When finished with a submenu definition, close it off with a right square brace.
  89.  
  90. An example of a menu definition of food items with some submenus would be:
  91.  
  92. Bread
  93. Fruit[Bananas;Apples;Kiwi;Oranges]
  94. Cheese
  95. Vegetables[Carrots;Spinach;Cabbage]
  96. Eggs
  97.  
  98. In this example, the Fruit and Vegetables each have a submenu associated with them.
  99.  
  100. 4. After creating your menu definition, close the field entry window and double-click on the PopMenu castmember to get the properties dialog. Here, you can specify different options for the behavior and display of the PopMenu, but the most important thing to do is to link your menu definition to the PopMenu castmember.
  101.  
  102. In the upper-left corner of the Properties dialog, you will see a popup menu (Macintosh) or a combo box (Windows) indicating the cast library and the field castmember for the menu definition. Go ahead and select the field castmember you just created, then close the Properties dialog.
  103.  
  104. 5. Select the PopMenu castmember in the Cast Window and name it "myPopup" in the field at the top of the window.
  105.  
  106. 6. Press the script button on the upper-right corner of the window. For the castmember script, type in the following:
  107.  
  108. on mouseDown
  109.         alert "You selected the menu item:" && the selectedText of member "myPopup"
  110.         alert "You selected the menu spec:" && the selectedSpec of member "myPopup"
  111. end
  112.  
  113. You should always check the mouseDown script for the selectedText and selectedSpec. The mouseUp script will not get activated under Windows if the user clicks the mouse down then up and then clicks the mouse down again to select a menu item.
  114.  
  115. If the selectedText or the selectedSpec is equal to an empty string (""), then the user made no menu selection.
  116.  
  117. Remember, this example is just to illustrate how the selectedText and the selectedSpec property work. After a PopMenu has been activated, the selectedText property will return the last selected text made by the user. The selectedSpec indicates the numerical positioning of the items. Unless you have multiple menu items with the same text or other special needs, you should use the selectedText property in favor of the selectedSpec.
  118.  
  119. 7. Finally, drag the PopMenu castmember anywhere on the stage and run the movie. Try selected some items from the menu and you will see just how easy the PopMenu is to use.
  120.  
  121. -------------------------------------
  122. Additional Technical Support and Help
  123. -------------------------------------
  124.  
  125. You can invoke the on-line help system for PopMenu by choosing "PopMenu-->Help" from the Xtras menu. To get a list of all of the PopMenu properties, you can get the propertyNames property and to get a list of the functions, you can get the functionNames property.
  126.  
  127. g/matter, inc. will respond to registered customers for all technical inquiries and licensing questions regarding PopMenu by e-mail at:
  128.  
  129. <support@gmatter.com>
  130.